home *** CD-ROM | disk | FTP | other *** search
/ Amiga Tools 5 / Amiga Tools 5.iso / grafik / 3d & render tools / xpgs-2.5 / readme.tut < prev    next >
Text File  |  1996-07-16  |  3KB  |  82 lines
  1. Remember to read INTRO and INSTALL before this.
  2.  
  3. For more information, read the man pages using something like
  4. "nroff -man xpgs.6 | more". In particular, xpgs.6 contains an
  5. overview of this suite of programs. For those without nroff (such as
  6. DEC VMS users), I have provided an abridged version of the man pages
  7. in xpgs.txt.
  8.  
  9. In general, if you get stuck read what's on the screen when the program
  10. starts. In the interactive X programs (xpgs, vpgs, xss) all keypresses,
  11. during program execution, must be done in the graphics window. Be sure that
  12. the programs (xpgs & vpgs) has finished the SIRDS generation (ie. after the
  13. "all done" message), otherwise the keypresses are buffered and not acted
  14. upon until the initial task is done.
  15.  
  16. Otherwise use the "-h" option to give yourself a summary of command line
  17. options, eg "xpgs -h". Note all options can be abbreviated to the least
  18. number of letters to be unique, clashes are resolved in the order of
  19. the options shown in the help.
  20.  
  21. For beginners, xpgs has a SHIMMER mode which depicts the same SIRDS but
  22. changes the background pixels. It aids the initial viewing of a SIRDS if you
  23. haven't seen one before.
  24.  
  25. Examples:
  26.   To view a single SIRDS frame of a tetrahedron,
  27.   try "xpgs tet" for wide-eyed (WE) viewing
  28.       "xpgs -S tet"  for WE with the SHIMMER mode
  29.   or  "xpgs -e 0.5 -m 0.4 -b 0.0 -r tet" for cross-eyed (CE) setting the
  30.       background plane to be at the origin.
  31.  
  32. * I haven't been able to check if the CE viewing works because I can't see
  33. * them in this way. If someone could try them out and email me with any
  34. * problems, I'll be most grateful.
  35.  
  36.   You can tweak the various options to get the SIRDS just right.
  37.   For CE viewing, the object size must be reduced by at least a
  38.   factor of two, i.e. set "-m 0.5". Also the depth effect must be
  39.   reduced by a similar amount, set "-e 0.5".
  40.  
  41.   These suggested values are not necessary true for any image,
  42.   you will have to experiment to find the right settings.
  43.  
  44. A quick tour to see a dinosaur:
  45.   1) tweak the .xss file using "xss dino" and save the result.
  46.   2) view the SIRDS animation (you can save a particular frame in here)
  47.       "xpgs -f 5 dino"
  48.   3) create a depth map
  49.       "cvtoppm -g 320x200 dino dino.pgm"
  50.   4) view the SIRDS of the depth map
  51.       "vpgs dino.pgm"
  52.   5) finally create a colour SIRDS
  53.      using xss file
  54.       "sisgen -R 2 dino -o | xv -"
  55.      using pgm file
  56.       "sisgen -R 2 -d dino.pgm -o | xv -"
  57.  
  58. Outputs:
  59.   There are two ways to dump the SIRDS image -
  60.        a)  xbm which can be potentially huge.
  61.        b)  Postscript which eats up about 320K in default settings.
  62.  
  63. Objects:
  64.   We have bundled some objects for you to try out -
  65.   regular solids in polyh format and a couple of objects converted from
  66.   X3d v2.0 objects and Wavefront objects. Also there are a number of builtin
  67.   objects which you can access in xss.
  68.  
  69.   More objects can be found at avalon ftp site or its mirrors
  70.   such as the one at wuarchive. See the INTRO file for the full names
  71.   and IP numbers.
  72.  
  73. Hints:
  74.   If you have compiled xpgs with the XPGSUSEPM option, the number of frames
  75.   of animation possible depends on the X server memory allocation, ie. the
  76.   number of big Pixmaps it can support. If your server can't handle a large
  77.   number then give xpgs a smaller number of frames, eg. "-f 3".
  78.   Alternatively, recompile xpgs without the XPGSUSEPM option.
  79.  
  80.   If your SIRDS don't look random then read the notes in INSTALL about the
  81.   SILLYRAND compilation option. 
  82.